Mover un archivo o directorio (file.move)
Declaración
éxito, mensaje_de_error = file.move(ruta_de_origen, ruta_de_destino [, modo])
Parámetros
- ruta_de_origen
Texto; ruta absoluta del archivo o directorio de origen. - ruta_de_destino
Texto; ruta absoluta completa del archivo o directorio tras el movimiento, incluido el nombre del archivo o directorio de destino. - modo 20250914+
Texto opcional, modo de movimiento:- cadena vacía u omitido: modo predeterminado (no-clobber); falla si el destino existe
- "overwrite" o "o": reemplaza directamente el destino existente (el destino existente se elimina)
- "merge" o "m": modo de fusión (solo para directorios); conserva los archivos que ya existen en el destino
- "overwrite-merge" u "om"/"mo": fusiona directorios y reemplaza archivos con el mismo nombre
Valores devueltos
- éxito
Booleano; devuelve true si tiene éxito y false si falla. - mensaje_de_error
Texto; mensaje de error cuando la operación falla.
Descripción
Mueve el archivo o directorio indicado por
ruta_de_origena la ruta exactaruta_de_destino; cambiar el nombre dentro del mismo directorio equivale a renombrarlo.
Esta función significa «mover como», no «mover dentro de».ruta_de_destinoespecifica el archivo o directorio final; no se añade automáticamente el nombre del archivo o directorio de origen. Aunque el destino ya exista y sea un directorio, o su ruta termine en/, la fuente no se colocará dentro de ese directorio.
Por ejemplo, para mover/a/b/cdentro de/d/e/conservando el nombrec, la ruta de destino debe ser/d/e/c, no solo/d/e/.
Si el destino ya existe, se aplica el parámetromodo: el modo predeterminado falla, el modo de sobrescritura reemplaza el propio destino y los modos de fusión de directorios fusionan el contenido del directorio de origen con el directorio de destino.
Palabras clave: renombrar o mover archivos, directorios y carpetas.
Disponible desde las versiones posteriores a 20250313.
Ejemplo
ok, err = file.move(XXT_SCRIPTS_PATH..'/1.zip', XXT_SCRIPTS_PATH..'/2.zip')
if not ok then
sys.alert('Error al mover: '..err)
end
Nota: el código anterior usa la función de otro capítulo sys.alert.
Mover a otro directorio conservando el nombre
-- Supongamos que /d/e es un directorio existente y que /d/e/c aún no existe
file.move('/a/b/c', '/d/e/c') -- Correcto: mover c a /d/e/c
-- Ejemplo incorrecto independiente: el destino es e, no c dentro del directorio e
-- file.move('/a/b/c', '/d/e/') -- Falla en el modo predeterminado porque el destino ya existe
-- El modo de sobrescritura reemplaza e y no crea /d/e/c (20250914+)
-- file.move('/a/b/c', '/d/e/', 'overwrite')
Definir una función para mover dentro de un directorio
El siguiente ejemplo define una función auxiliar personalizada y requiere una versión posterior a 20250914. El directorio de destino debe existir. La función conserva el nombre del archivo o directorio de origen y pasa el parámetro opcional mode a file.move. Los conflictos de nombres se siguen resolviendo según el modo indicado.
local function file_move_into(src_path, dst_dir, mode)
if file.exists(dst_dir) ~= "directory" then
return false, "Target is not a directory"
end
local name, err = file.path.last_component(src_path)
if not name then
return false, err
end
-- Evita usar el propio directorio de destino o su directorio padre como destino final.
if name == "" or name == "/" or name == "." or name == ".." then
return false, "Source path must end with a file or directory name"
end
local dst_path, path_err = file.path.add_component(dst_dir, name)
if not dst_path then
return false, path_err
end
return file.move(src_path, dst_path, mode)
end
-- Supongamos que /d/e es un directorio existente; mover c a /d/e/c
local ok, err = file_move_into("/a/b/c", "/d/e/")
if not ok then
print("Error al mover: "..err)
end
-- Para reemplazar /d/e/c, indique el modo de sobrescritura al llamar a la función:
-- file_move_into("/a/b/c", "/d/e/", "overwrite")
Nota: el código anterior usa file.exists, file.path.last_component y file.path.add_component.